Получение детального оффера

Запрос позволяет получить детальный оффер результатов поиска.

Синтаксис запроса

POST https://b2b-api.go.yandex.ru/integration/integration/v2/avia/flights/search-result-offer

Заголовки запроса

  • Authorization: Bearer <OAuth-token>
    OAuth access token. The steps to get a token are described in Getting started.
  • X-YaTaxi-Selected-Corp-Client-Id — идентификатор клиента из личного кабинета. Обязателен, если по токену доступно несколько клиентов.

Тело запроса

Данные передаются в формате JSON:

Поле

Описание

Формат

Обязательность

search_result_id

Идентификатор результата поиска.

Строка

Да

Описание полей ответа

В ответе могут содержаться следующие поля:

Поле

Описание

Формат

Обязательность

airlines

Список авиакомпаний.

Массив

Да

locations

Список локаций.

Массив

Да

baggages

Список багажа.

Массив

Нет

flights

Список рейсов.

Массив

Да

time_limit

Время, до которого действует оффер.

Строка в формате даты и времени

Да

request_parameters

Параметры запроса поиска.

Параметры запроса поиска

Да

result

Результат

Объект

Да

Структура объекта airlines:

Поле

Описание

Формат

Обязательность

code

Код авиакомпании, например: "SU".

Строка

Да

name

Название авиакомпании, например: "Аэрофлот".

Строка

Да

logo_svg

Логотип в SVG.

Строка

Да

Структура объекта locations:

Поле

Описание

Формат

Обязательность

airport

Код аэропорта.

Строка

Да

airport_name

Название аэропорта.

Строка

Да

city

Код города.

Строка

Да

city_name

Название города.

Строка

Да

country

Код страны.

Строка

Да

country_name

Название страны.

Строка

Да

Структура объекта flights:

Поле

Описание

Формат

Обязательность

flight_id

Идентификатор рейса.

Строка

Да

flight_number

Номер рейса.

Строка

Да

airline

Код авиакомпании.

Строка

Да

board

Борт.

Строка

Да

board_name

Название борта.

Строка

Да

departure_airport

Аэропорт вылета.

Строка

Да

departure_time

Время вылета.

Строка в формате даты и времени

Да

arrival_airport

Аэропорт прилета.

Строка

Да

arrival_time

Время прилета.

Строка в формате даты и времени

Да

tech_stops

Технические остановки.

Массив

Нет

baggage

Идентификатор багажа.

Строка

Нет

cabin_baggage

Идентификатор ручной клади.

Строка

Нет

Структура объекта results:

Поле

Описание

Формат

Обязательность

route_id

Идентификатор маршрута.

Строка

Да

forward_trip

Прямой рейс.

Поездка

Да

backward_trip

Обратный рейс. Структура аналогична forward_trip.

Поездка

Да

tariff_variants

Тарифные варианты для этого маршрута.

Массив

Да

Структура объекта tariff_variants:

Поле

Описание

Формат

Обязательность

search_result_id

Идентификатор результата поиска.

Строка

Да

charter

Чартер.

Булево

Да

baggage

Идентификатор багажа.

Строка

Нет

cabin_baggage

Идентификатор ручной клади.

Строка

Нет

total_cost

Общая стоимость

Цена

Да

extra_charge_cost

Сервисный сбор.

Цена

Да

ancillary_fees_request_needed

Нужно ли запрашивать допонительные услуги.

Булево

Да

refundable_before_departure

Возвратный до вылета.

Булево

Нет

refundable_after_departure

Возвратный после вылета.

Булево

Нет

travel_policy_info

Информация о политике путешествий.

Информация о политике путешествий

Нет

is_3d

3D-контракт.

Булево

Нет

change

Информация об изменениях в тарифе.

Варианты изменений в тарифе

Нет

Структура объекта change:

Поле

Описание

Формат

Обязательность

cabin_baggage

Изменения в ручной клади.

Изменения в ручной клади

Нет

baggage

Изменения в багаже.

Изменения в багаже

Нет

refundable_before_departure

Изменение возвратности до вылета.

Изменение возвратности до вылета

Нет

total_cost

Изменение стоимости.

Изменение стоимости

Нет

Структура объекта cabin_baggage:

Поле

Описание

Формат

Обязательность

previous_value

Предыдущее значение.

Изменения в полях багажа

Да

current_value

Текущее значение.

Изменения в полях багажа

Да

Структура объекта previous_value:

Поле

Описание

Формат

Обязательность

pieces

Количество мест.

Число

Да

weight

Вес в кг.

Число

Да

size

Размер в см.

Число

Да

description

Описание.

Строка

Нет

Структура объекта refundable_before_departure:

Поле

Описание

Формат

Обязательность

field_name

Название поля.

Строка

Да

previous_value

Предыдущее значение.

Булево

Нет

current_value

Текущее значение.

Булево

Нет

Структура объекта total_cost:

Поле

Описание

Формат

Обязательность

field_name

Название поля.

Строка

Да

previous_value

Предыдущее значение.

Строка

Нет

current_value

Текущее значение.

Строка

Нет

включая сервисный сбор

комбинация Route и TariffVariant